home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 April / EnigmA AMIGA RUN 06 (1996)(G.R. Edizioni)(IT)[!][issue 1996-04][Skylink CD V].iso / earcd / utilgfx / xpntmd40.rdm < prev   
Text File  |  1996-03-13  |  16KB  |  350 lines
  1. Short:    Univ. loader&anim.saver for XiPaint
  2. Author:   hhoff@pool.informatik.rwth-aachen.de (Helmut Hoffmann)
  3. Uploader: hhoff@pool.informatik.rwth-aachen.de (Helmut Hoffmann)
  4. Type:     gfx/misc
  5. Kurz:     XiPaint-Universal-Lader&Animationssp.Modul
  6.  
  7. HHsFastUniversalXiPaintModule 4.0 (incl. PhotoCD- & TrueColorAnim-support)
  8. =================================
  9.  
  10. new in V4.0: Downscaled loading support: Loading big pictures in downscaled
  11.         form can save much memory and time. Finally a way to get
  12.         your "too big" pictures into XiPaint...
  13.     Included JPeg support (esp. useful e.g. for downscaled loading)
  14.     Automatic installation script added.
  15. new in V3.0: TrueColor animation saving support in HHsYUVSq animation format
  16.     ->create your own TrueColor animations for playback on CyberGraphX
  17.       with CyberTVPlayer or on EGS with EGSTVPlayer <-
  18.     Including ARexx script for automatic conversion of picture
  19.       directories into HHsYUVSq animation format
  20.  
  21. This universal module can be used to load images in many file formats
  22. (more than 20 and additionally Datatypes) very fast into XiPaint (including
  23. optional downscaling) and to create TrueColor animations in HHsYUVSq
  24. animation format.
  25.  
  26. Installation
  27. ------------
  28.  
  29. The module can be installed automatically with the included script: Simply
  30. start it and select the XiPaint main directory in the file requester. The
  31. needed files will then be installed.
  32.  
  33. If you prefer manual installation: "hhsxipaintmod.xio" is the main module
  34. and should be copied to the XiPaint/Modules directory for XiPaint 3.2 and up.
  35. For older versions the module should be copied to the XiPaint main directory
  36. and the additional ARexx script "hhsxipaintloader.rx" should come into
  37. the XiPaint/Makro directory. For all versions the "makeanim.rx" script can
  38. be installed in the XiPaint/Makro or XiPaint main directory.
  39.  
  40. Usage
  41. -----
  42.  
  43. 1) XiPaint 3.2 or higher: The module will be detected by XiPaint 3.2
  44.  
  45.   a) as "HHsUniversalLoader", "Universal_50%_size" and "Universal_25%_size"
  46.      which you can then select in the Settings/Loaders list of loader
  47.      modules. The Loader will be automatically used (if selected) for
  48.      opening of new projects and for loading into existing projects.
  49.      To load pictures in half or quarter size, use the %_size loaders.
  50.  
  51.   b) as "HHsYUVSqAnimation" which you can then select in the Settings/Savers
  52.      list of saver modules. To create a new animation, select a new filename
  53.      for saving with this format; to append a frame to an existing animation,
  54.      select the existing animation file for saving. XiPaint will warn you
  55.      that the file is overwritten, but the module will only append the frame
  56.      and not delete the old file.
  57.  
  58.      Please note: Image width must be in the range 80 to 360 (even size will
  59.      be generated); Image height must be in the range 64 to 310. To append
  60.      frames to an animation, the image size in XiPaint must match the frame
  61.      size of the file you want to append to. Otherwise (or if you specify
  62.      not a HHsYUVSq anim file) an error will occur.
  63.  
  64.    To automatically create an animation from a directory of pictures you
  65.    can use the included ARexx script "makeanim.rx". This will do automatic
  66.    downscaling. Please see notes below.
  67.  
  68. -> XiPaint 3.2-CD: If you have problems with XiPaint 3.2 on CD-ROM,
  69.    you should check your file system; some CD file systems
  70.    only support upper case file names; XiPrefs looks only for
  71.    lower case xout-libraries; use another file system or rename
  72.    the libraries to lowercase manually (on your harddisk) like
  73.    rename XiPaint/libs/XOUT_C.LIBRARY "XiPaint/libs/xout_c.library"
  74.    etc... This should solve your problems.
  75.  
  76. 2) XiPaint 3.0/3.1
  77.  
  78.   As thoose XiPaint versions have no direct support for external modules,
  79.   you can only access it by the included ARexx scripts.
  80.  
  81.   a) For loading: Execute the "hhsxipaintloader.rx" macro (with the
  82.      menu function Macro/Execute).
  83.      It will then switch to the WB screen and display a standard
  84.      file requester. You can then select a file for loading. The
  85.      picture will be loaded if possible and transferred to XiPaint
  86.      as a new project window. Then the WB screen is sent back so
  87.      that XiPaint screen should appear in front again. Some XiPaint
  88.      versions add absolute path names of new project windows to the
  89.      relative standard path. I can't work around this, so such
  90.      pictures will get wrong project names with such versions (Only
  91.      use SaveAs to save such pictures). Please upgrade to XiPaint 3.2
  92.      to get a more convenient access to my module...
  93.  
  94.   b) For TrueColor animation creation: Execute the automatic script
  95.      "makeanim.rx"; see below for details.
  96.  
  97. Supported file formats
  98. ----------------------
  99.  
  100. Supported file formats for loading:
  101.  
  102. * IFF-ILBM (all standard formats 1 to 8Bit, EHB, HAM6, HAM8, 24Bit)
  103. * JPeg (color and greyscale; see notes below)
  104. * PhotoCD (Base format 768x512 or 512x768 (portrait); linear 24Bit colors)
  105. * PPM/PGM/PBM (P1&P4 b&w, P5 grey, P6 color)
  106. * QRT (also known as dump format by PD raytracers as POV-Ray)
  107. * Targa (RLE compr.&uncompr. 1/8/15/16/24/32Bit;incl. interleaved)
  108. * PCX (compr.&uncompr. EGA1-4Bit, VGA 8Bit grey/Colormap and 24Bit)
  109. * MacPaint (b&w compressed 1Bit format; datafork only)
  110. * BMP (uncompr. 24Bit RGB,1Bit,4Bit or 8Bit Colormap; RLE compressed 8Bit,1Bit)
  111. * TIF (packbit-compr.&uncompr. 24Bit,1-8Bit grey/Color Motorola&Intel formats)
  112. * EGS7.x window iconification file format
  113. * DEEP (compr.&uncompr. 24Bit and 32Bit)
  114. * RGB formats (RGB8, RGBN, RGB5)
  115. * ACBM formats (1 to 8Bit, incl. HAM6/HAM8)
  116. * FBM formats (8Bit grey/color and 24Bit)
  117. * IFF-PBM (DPII) format
  118. * Sun raster (1Bit, 8Bit grey/color and 24Bit uncompressed)
  119. * YUV (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  120. * VLAB raw (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  121. * HHsYUVSq sequence format (sequential or random access; only first frame)
  122. * HHsXRL formats (1-8Bit ColorMap incl. HAM6/8, 8Bit grey, 24Bit RGB compressed)
  123. * binary-EPS bitmaps (RGB and CMYK; this function is experimental)
  124. * TBCPlus frames&fields
  125.  
  126. * DataType (incl. first frame of animations with Anim-Datatypes)
  127.  
  128. Supported file formats for saving:
  129.  
  130. * HHsYUVSq animation format
  131.  
  132. Automatic creation of HHsYUVSq TrueColor animations
  133. ---------------------------------------------------
  134.  
  135. With the script "makeanim.rx" you can automatically convert a directory
  136. of pictures into an HHsYUVSq animation file. Just start the script
  137. from XiPaint as macro or from Workbench or Shell. It should work with
  138. all XiPaint 3.x and up versions. If you start it from XiPaint, you will
  139. probably have to switch to WB screen manually; there you get a requester
  140. asking for the source directory which should contain the pictures
  141. (all of the same size). Then you are asked for the destination animation
  142. file. Then the automatic conversion is started. Pictures are downscaled
  143. if necessary. You can watch the pictures beeing loaded in XiPaint. They
  144. are loaded in alphabetical order (users of old XiPaint versions prior to
  145. V3.2 should NOT play with XiPaint during this process as this can
  146. block the whole system). With newer versions it should be save to
  147. use XiPaint for other things during the process except loading as
  148. this would interact with the frame loading! If the conversion has finished,
  149. the last picture will remain in XiPaint as a project. You can close
  150. this manually.
  151.  
  152. To play the animations use my freeware player programs
  153. CyberTVPlayer for TrueColor playback on CyberGraphX compatible
  154. boards (incl. Draco) or EGSTVPlayer for TrueColor playback on
  155. EGS compatible boards. CyberTVPlayer can also be used without
  156. CyberGraphX for reduced viewing (upto 256 colors) on all Amigas
  157. with at least OS3.0.
  158.  
  159. Additional notes: The loading/saving is done with HHsXiPaintMod.xio
  160. only; so you can only load pictures in one of the supported formats
  161. (see above). If you want to make animations from pictures in other formats,
  162. you have to load and save them with the appropriate modules manually.
  163. But anyway, the module now seems to support nearly all formats...
  164.  
  165. Downscaled loading
  166. ------------------
  167.  
  168. The loader module now supports direct downscaled loading in XiPaint 3.2
  169. and higher; simply select the appropriate loader version in the list.
  170. Currently the loader should appear 3 times: HHsUniversalLoader for full
  171. size, Universal_50%_Size for half size and Universal_25%_Size for quarter
  172. size. For most file formats (e.g. IFF, DEEP, JPeg, PCX, PPM, Targa, ...)
  173. the downscaling is done on a line by line base, so that memory will only
  174. be needed for the reduced size. This should enable you to get big
  175. pictures into XiPaint without memory problems.
  176.  
  177. General notes
  178. -------------
  179.  
  180. There are currently no error requesters for loading (if a file can not be
  181. loaded nothing will happen). For saving error requesters are included.
  182.  
  183. If you register for the XiPaint modules you will receive a
  184. keyfile together with the latest version of the modules. The
  185. keyfile will enable you to use future demo versions as update.
  186.  
  187. The demo version will load and save all pictures in greyscales, but
  188. usually at the same speed as the full version would do in color.
  189.  
  190. XiPaintModules need at least OS2.04 (OS3.x for Datatype usage).
  191.  
  192. All loading functions (except JPeg: This software is based in part on the work
  193. of the independent JPeg Group) have been written in Assembler and optimised for
  194. extremely high speed. An exception to this is the JPeg format, which is
  195. written in C and based on the usual code of the indipendent JPeg group.
  196. I created the fast loading functions mainly for my famous shareware programs
  197. *** CyberShow Professional *** (universal viewer and slideshow program
  198. for all OS3.x Amigas and Dracos and esp. for CyberGraphX users), EGSPhotoAlbum
  199. Prof. and EGS-TV Prof.; When new formats are implemented for my other
  200. programs (or the speed is improved further), I will usually also update
  201. the modules, which registered user can then use due to the keyfile concept.
  202.  
  203. The JPeg format has been included in this module mainly for the comfort
  204. of the users (as otherwise for JPeg another loader module would have to
  205. be seleted) and to enable JPeg loading in downscaled form, which can be
  206. very useful. Now you can also create animations in HHsYUVSq animation
  207. format from JPeg pictures with the automatic ARexx script. The loading
  208. speed of the JPeg code (for pictures in full size) is unfortunately
  209. currently not very fast. Downscaled loading of JPeg can be much faster.
  210.  
  211. Registration
  212. ------------
  213.  
  214. You can register for the module at the small add-on price of only 8US$ or
  215. 10DM if you order it together with one of my other shareware programs,
  216. e.g. CyberShow, the universal viewer and slideshow program for all Amigas
  217. with at least OS3.0 (loading the same formats as the XiPaintModule and
  218. additional JPeg) or EGSPhotoAlbum or EGS-TV. Please use the registration
  219. forms of thoose programs and specify your add-on module order there and
  220. include the extra amount.
  221.  
  222. Otherwise you should use the included registration form to register:
  223.  
  224. If you only want to register for the module, the registration fee is
  225. 18US$ outside europe or 20DM in europe. You will also get the latest demo
  226. versions of my other programs. Additional modules (e.g. UniversalGIO for
  227. Photogenics or FastIFXModules for ImageFX) can be ordered at the lower
  228. add-on price.
  229.  
  230. If you are already a registered user of one of my programs and now want to
  231. register for the modules, the registration fee is 13US$ outside europe or
  232. 15DM (in europe). This includes the latest versions of my programs as update.
  233. Additional modules (e.g. UniversalGIO for Photogenics or FastIFXModules for
  234. ImageFX) can be ordered at the lower add-on price.
  235.  
  236. (Special note for users in germany only: Wenn Sie schon registrierter Benutzer
  237.  eines meiner Shareware-Programme sind und sich Ihre Anschrift nicht
  238.  geändert hat, können Sie die Module direkt per Überweisung bestellen.
  239.  Als Verwendungszweck geben Sie bitte "XiPaintMod für ...." an, wobei Sie
  240.  das Programm was Sie schon haben und die Registriernummer angeben.
  241.  Zusätzlich möglichst auch noch Name/Anschrift; die Bankverbindung:
  242.  Konto-Nr. 5740147 BLZ 310 500 00 Stadtspark. Mönchengladbach)
  243.  (No bank transfers from outside germany!)
  244.  
  245. Send your filled in registration form together with cheque, international
  246. postal money order or banknotes to:
  247.  
  248.                         Helmut Hoffmann
  249.             Rubensstrasse 4
  250.             D-41063 Mönchengladbach
  251.  
  252.             Germany
  253.  
  254. You can currently also contact me by EMail (e.g. for suggestions):
  255.  
  256.         hhoff@pool.informatik.rwth-aachen.de
  257.  
  258. No registrations by EMail! If you want to register, please write by ordinary mail
  259. to my address above.
  260.  
  261. Special Thanks
  262. --------------
  263.  
  264. My special thanks go to Mr. Thomas Dorn and Ossowski's Schatztruhe for
  265. providing me with XiPaint.
  266.  
  267. Disclaimer
  268. ----------
  269.  
  270. This software (program and documentation) is provided "as is" and
  271. comes with no warranty, either expressed or implied.
  272. The author is in no way responsible for any damage or loss that may
  273. occur due to direct or indirect usage of this software. You use
  274. this software entirely at your own risk.
  275.  
  276. Copyright and Distribution
  277. --------------------------
  278.  
  279. HHsFastUniversalXiPaintModule (module and documentation) is copyright by
  280.  
  281.                         Helmut Hoffmann
  282.             Rubensstrasse 4
  283.             D-41063 Mönchengladbach
  284.  
  285.             Germany
  286.  
  287. The demo version may be freely distributed and used as
  288. long as the following conditions are met:
  289.  
  290. 1) All files have to be kept together
  291.  
  292. 2) No file may be modified or crunched/packed.
  293.  
  294.    The only official way to distribute the demo packed is the
  295.    original xipaintmod.lha archive.
  296.    The modules may not be disassembled or analysed. The limitations
  297.    integrated in the demo version may under no circumstance be removed
  298.    or bypassed.
  299.  
  300. 3) Distributors may only charge for the duplication process (including media)
  301.    and not for the software. Theese charges may not exceed the following
  302.    limits: a) Demo on a PD-disk: 7$ (US-dollar) including
  303.               postage&packing (in Germany: 10DM)
  304.        b) Demo on a PD-CD-ROM: 40$ (US-dollar) including
  305.               postage&packing (in Germany: 60DM)
  306.        c) Demo on a BBS/Mailbox/ftp-site or other electronically
  307.               callable system: Maximum charge 3$ (US-dollar) (in Germany: 5DM)
  308.               for downloading
  309.    Anyway, it must be made explictly clear to the buyer, that he does not
  310.    pay for the modules (demo) itself but only for the duplication service.
  311.  
  312. 4) It is not allowed to distribute this demo with any commercial product
  313.    without a written permission by me. One exception is the distribution of
  314.    the demo version with products not exceeding the above price limits (e.g.
  315.    a cover-disk magazine for 7$ or less).
  316.  
  317.    The demo version may be included with XiPaint.
  318.  
  319. 5) The registered version may not be redistributed. It may only run on one
  320.    machine per registration. It is allowed to make a backup copy of the
  321.    original disk.
  322.  
  323. Version history
  324. ---------------
  325.  
  326. V0.1 (7th aug. 95): Prerelease for loading functions
  327. V0.2 (20th aug. 95): Prerelease for loading by ARexx script:
  328.             added Request option and screen switching functions
  329. V1.0 (15th sep. 95): First official release for use by Arexx script (usable
  330.             with XiPaint 3.x)
  331. V2.0 (21st sep. 95): First release with direct loader module support for
  332.             XiPaint 3.2 (just copy the .xio file into the
  333.             XiPaint/Modules directory and configure it as loader)
  334. V2.1 (9th oct. 95): Extended TIF loader to support "Intel" byte order files
  335.             and more variants
  336. V3.0 (11th dec. 95): TrueColor animation saving: extended module to support
  337.             saving in HHsYUVSq animation format;
  338.             included ARexx script to automatically create such
  339.             animations from multiple pictures
  340.              Extended IFF loader to accept 0-sized chunks
  341.              Loader can now load bigger pictures into smaller projects
  342.              Integrated downscaling support (only usable by scripts)
  343. V4.0 (9th feb. 96): Support for downscaled loading (50% size, 25% size) by
  344.             additional entries in the XiPaint 3.2 loader list
  345.             Added JPeg loading support (see special notes for JPeg!)
  346.             Included script for automatic installation of modules
  347.             Bug fixes in makeanim.rx script: now should also work
  348.             if other project windows exist during anim creation
  349.             Extended IFF loader to accept unusual sized color maps
  350.